專案資訊

專案名稱

黃金儀表板｜XAUUSD K線、支撐壓力與 AI 市場分析

專案簡介

黃金儀表板是一個以市場研究為導向的XAUUSD Web儀表板，將即時價格、不同時間週期的 K 線圖、黃金新聞、市場背景，以及支撐與壓力觀察整理在同一個介面中。

這個專案想解決的問題，是讓使用者不需要在多個頁面之間切換，就能比較價格、圖表與市場背景。不過，這裡的重點不是提供買賣訊號，而是讓市場資料更容易被閱讀、比較與追蹤。

開發狀態

Beta 測試中，持續改善資料更新、圖表載入與多語言介面。

必要連結

專案頁面：https://copi-tools.com/zh-hant/gold-dashboard/

技術實作內容

1. 開發動機

市場儀表板中的資料不會以相同速度變化。

即時價格可能需要較頻繁更新，K 線歷史資料可以依照時間週期快取，而新聞與市場背景則適合使用較慢的更新週期。如果所有區塊都使用同一個計時器重新載入，就會產生不必要的請求，也可能中斷使用者正在閱讀的內容。

因此，我希望把不同資料類型放在同一個介面中，同時讓每個區塊依照自己的資料特性更新。

2. 技術架構

黃金儀表板以 WordPress plugin 的形式實作，主要分成以下幾個部分：

• WordPress plugin 負責輸出儀表板的初始 HTML。
• JavaScript 負責加入 K 線圖、主題切換與局部 fragment 更新。
• API 依照 symbol、timeframe 與資料天數提供圖表資料。
• K 線資料支援 M1、M5、M15、M30、H1、H4 與 D1 等時間週期。
• 即時價格、圖表最新資料、新聞與市場背景分別使用不同的更新週期。

MT5、VPS 與 WordPress 的資料流程

前端儀表板背後還有一條在 Windows Server VPS 上執行的資料流程。這部分使用 MT5 與 MQL5 EA，把外部行情整理後送到 WordPress REST API：

• send-price-swap-copi.mq5 從 MT5 取得 XAUUSD 的 M1 K 線，透過 gold-bars API 傳送到 WordPress。
• gold-analysis-export.mq5 輸出分析用的 OHLC、EMA、RSI、ATR、MACD 與 Bollinger Bands 資料。
• VPS 上的 Python 排程讀取 JSON，呼叫 Gemini API 進行分析並驗證結果，再透過 gold-analysis API 傳回 WordPress。
• WordPress 將圖表資料與分析結果分開保存，前端依照不同區塊取得需要的資料。

這樣可以把「行情收集」、「分析處理」、「資料保存」和「瀏覽器呈現」分成不同層次，後續調整某一個流程時，不必同時修改整個儀表板。

第一次載入時，伺服器先輸出有意義的 HTML；JavaScript 載入後，再逐步加入圖表與局部更新。這種方式可以避免使用者必須等待所有 JavaScript 完成後，才看得到主要內容。

3. 核心邏輯與技術挑戰

不同資料需要不同的更新速度

價格變化較快，應該使用較短的更新週期；新聞與市場背景則不需要每幾秒重新請求。若所有區塊共用一個計時器，慢速資料會被重複抓取，快速資料也會拖累整個頁面更新。

另外，VPS上的行情收集與分析任務也不是同一種工作。圖表需要持續接收較新的 M1 資料，分析流程則需要等待足夠的確定 K 線，再依照時間週期執行。把兩者混在同一個排程中，會讓延遲和錯誤更難追蹤。

不應該每次重新載入完整圖表歷史

使用者切換時間週期後，如果每次都重新取得完整歷史資料，資料量和回應時間都會增加。另一方面，使用者通常只需要知道圖表最近發生了什麼變化，而不是每次都重新下載所有舊資料。

單一 request 失敗不應該清空整個介面

市場資料來自不同的資料流程，某一個 request 變慢或失敗是可能發生的。如果一個區塊的錯誤讓整個頁面顯示空白，使用者就很難判斷到底是資料暫時無法更新，還是整個系統停止運作。

4. 解決方案

首先，我把頁面拆成多個可以獨立更新的 fragment。即時價格使用較短的週期，新聞與市場背景使用較慢的週期，圖表則分成歷史資料與最近的資料尾端處理。

歷史 K 線資料依照 timeframe 快取。當使用者查看同一個時間週期時，不必每次都重新下載完整歷史；後續更新只需要取得最近的資料，再更新圖表尾端。

其次，每個 fragment 都獨立處理錯誤。當新資料取得失敗時，先保留目前畫面上的內容，並讓使用者知道該區塊可能尚未更新。其他區塊則繼續運作，不會因為單一 request 失敗而全部消失。

這種 fail-soft 設計雖然不會讓所有資料看起來都像是即時更新，但能讓狀態更容易理解。對資料型介面來說，一個清楚標示尚未更新的區塊，通常比一個沒有說明的空白卡片更有用。

目前的限制與後續方向

目前的主要工作仍是調整資料更新週期、圖表載入速度與不同語言介面的使用體驗。接下來會繼續觀察哪些資訊應該在第一個畫面出現，以及如何在保留市場背景的同時，避免介面變得過於複雜。

黃金儀表板是市場資訊整理與研究介面，不是交易訊號工具，也不執行自動下單。價格、新聞與其他資料可能存在延遲，內容不構成投資建議，也不保證任何交易結果。

如果你也曾經開發過包含多種資料來源的 dashboard，歡迎分享你如何設計更新週期、資料快取和錯誤處理。